home *** CD-ROM | disk | FTP | other *** search
/ Wildcat Gold - The Optical BBS / Wildcat Gold - The Optical BBS (The Golden ROM Series)(Volume 4 Number 1)(The Digital Publishing Company)(1992).ISO / sdn / 4dos400p.sdn / UPDATE40.DOC < prev    next >
Text File  |  1991-11-28  |  37KB  |  753 lines

  1.  
  2.  
  3.                               4DOS Update Documentation
  4.  
  5.                            Version 4.0 -- November 18, 1991
  6.  
  7.         Copyright 1988 - 1991, JP Software Inc., All Rights Reserved.  Pub-
  8.         lished by JP Software Inc., P.O. Box 1470, E. Arlington, MA 02174 USA,
  9.         (617) 646-3975.
  10.  
  11.  
  12.         Version 4.0 is a major new release and many parts of 4DOS have
  13.         changed.  The list below summarizes these changes for version 3.0
  14.         through 3.03 users; users who are new to 4DOS with version 4.0 can
  15.         skip this information.
  16.  
  17.         This file is a summary list only, it doesn't explain how to use new
  18.         features and enhancements.  For more details on items which are relat-
  19.         ed to a specific command, see that command's entry in the command
  20.         reference section of the manual.  For other items, look up the subject
  21.         the item discusses in the manuals's table of contents or index to find
  22.         more information.
  23.  
  24.         Some of the descriptions below may be more detailed than you need; if
  25.         you aren't using the feature described, feel free to skip through to
  26.         the next item!
  27.  
  28.         Items in this file marked with "**" are changes that occurred after
  29.         the manual went to press.  These items are more fully documented in
  30.         the MANMOD.DOC file distributed with registered copies of 4DOS and in
  31.         the ASCII (on-disk) manual, but are not documented in the printed
  32.         manual.
  33.  
  34.  
  35.         Installation and Configuration
  36.         ------------------------------
  37.  
  38.            4DOS is now a single file, 4DOS.COM.  The old structure of separate
  39.            4DOS.COM and 4DOS88.EXE / 4DOS286.EXE files has been eliminated.
  40.  
  41.            There is a wide variety of new startup options for 4DOS, ranging
  42.            from the simple to the highly technical.  Most of the startup
  43.            switches that used to go on the SHELL= line in CONFIG.SYS or in the
  44.            4DSHELL environment variable have been eliminated, and 4DOS config-
  45.            uration is now controlled through the new 4DOS.INI file, for both
  46.            primary and secondary shells.  Those switches which still work for
  47.            DOS compatibility reasons (such as /E: for environment size) can
  48.            also be set through 4DOS.INI.
  49.  
  50.            If you install 4DOS manually or have a complex configuration, you
  51.            should read about 4DOS.INI in the manual before modifying your
  52.            SHELL= line to load version 4.0!  See Chapter 6 for more details.
  53.  
  54.  
  55.         4DOS 4.0  [11-18-91]         UPDATE40.DOC                       page 1
  56.  
  57.  
  58.            The following summary lists version 3 startup switches and the
  59.            corresponding 4DOS.INI directive for version 4.0.  Switches marked
  60.            with a "*" are still available in version 4.0, in order to maintain
  61.            compatibility with DOS.
  62.  
  63.               Ver. 3 Switch     Function                4DOS.INI Directive
  64.               -------------     -------------------     ------------------
  65.                  /A:nnnn        Set alias list size     Alias = nnnn
  66.                  /C*            Execute one command     none
  67.                  /E:nnnn*       Set environment size    Environment = nnnn
  68.                  /E:nnnnU       Load environment high   UMBEnvironment = Yes
  69.                  /H:nnnn        Set history list size   History = nnnn
  70.                  /L:path        Set EXE file location   none, not needed
  71.                  /P*            Load permanently        none
  72.                  /R             Disable reduced swap    Reduce = No
  73.                  /S:type        Set swap type           Swapping = swap type
  74.                  /U             Load 4DOS high          UMBLoad = Yes
  75.                  /V             (Used with Windows)     none, automatic
  76.  
  77.            The KEYSTACK.SYS device driver is no longer used.  It has been
  78.            replaced by KSTACK.COM, a TSR (memory-resident program), normally
  79.            loaded from AUTOEXEC.BAT (or with INSTALL= in CONFIG.SYS).
  80.  
  81.            The /P switch is now set automatically when 4DOS is loaded as the
  82.            true primary shell via a SHELL= statement in CONFIG.SYS.
  83.  
  84.            4DOS now supports the COMMAND.COM syntax for specifying a COMSPEC
  85.            directory in the SHELL statement.  See "Setting up CONFIG.SYS".
  86.            However (see next item) ...
  87.  
  88.            Under MS-DOS and PC-DOS you probably won't need to set the COMSPEC
  89.            directory on the SHELL= line or in AUTOEXEC.  4DOS sets it automat-
  90.            ically in most cases, provided that you specify the full path for
  91.            4DOS.COM in the name you use on the SHELL= line in CONFIG.SYS.  If
  92.            you use DR-DOS automatic determination of the COMSPEC directory
  93.            will NOT work, so you will have to set the directory yourself on
  94.            the SHELL= line.  (Thanks to Hans Salvisberg, author of BOOT.SYS,
  95.            for the technical information needed to implement the automatic
  96.            COMSPEC directory feature!).  See "Setting up CONFIG.SYS".
  97.  
  98.            4DOS can now load its resident portion and / or the master environ-
  99.            ment into DOS 5 UMBs.  DOS 5 UMBs are used automatically if they
  100.            are available and if UMB access is requested with the UMBLoad or
  101.            UMBEnvironment directive in 4DOS.INI.
  102.  
  103.            Swapping is now controlled by the Swapping directive in 4DOS.INI.
  104.            You can use this directive to set up any sequence of swapping at-
  105.            tempts you like (for example, you can tell 4DOS to try EMS, then
  106.            your RAM disk, then XMS, then the hard disk).  If no Swapping di-
  107.            rective is used the default is to try EMS, then XMS, then the root
  108.            directory of the boot drive if it is drive C: or higher.  4DOS will
  109.  
  110.  
  111.  
  112.  
  113.         4DOS 4.0  [11-18-91]         UPDATE40.DOC                       page 2
  114.  
  115.  
  116.            no longer attempt to swap to drive A: or B: by default (though you
  117.            can tell it to if you want to).  If all of these methods fail, 4DOS
  118.            will load resident.
  119.  
  120.            Most SETDOS settings can be initialized in the 4DOS.INI file.
  121.            SETDOS settings are now inherited automatically in secondary
  122.            shells, so you no longer need to put a SETDOS command into the
  123.            4START file to get the right settings in secondary shells.
  124.  
  125.            The LOG state and log file name are now inherited by secondary
  126.            shells, and may be set at boot time using the LogName directive in
  127.            4DOS.INI.
  128.  
  129.            For BBS operators, the /F startup switch (or the CritFail directive
  130.            in 4DOS.INI) generates an automatic "fail" response to all critical
  131.            errors.
  132.  
  133.  
  134.         General Features
  135.         ----------------
  136.  
  137.            The PATH search is now faster by 50 - 100% depending on where the
  138.            file is found in the path.
  139.  
  140.            Secondary shells now require only about 1.7K of resident space
  141.            (down from about 2.8K in version 3.03).  The primary shell require-
  142.            ment is still 3K or less under most circumstances.
  143.  
  144.            Description file processing has been sped up substantially, and
  145.            should generate much less network traffic than before.
  146.  
  147.            Directory displays in DIR and SELECT can now be colorized based on
  148.            file extension or attributes.  See "COLORDIR".
  149.  
  150.            "Include lists" which allow you to specify multiple files with a
  151.            single path were only available for the DIR and SELECT commands in
  152.            4DOS 3.03.  In version 4.0 they have been extended to all 4DOS file
  153.            processing commands, and the separator character has been changed
  154.            to a semicolon.  For example, the command:
  155.  
  156.                  copy d:\data\*.dat;*.txt a:
  157.  
  158.            will copy the .DAT and .TXT files from D:\DATA to drive A:.  See
  159.            "Include Lists".
  160.  
  161.            Wildcards have been enhanced so that you can specify lists or rang-
  162.            es of characters to include or exclude.  For example [abf-h]*.*
  163.            means all files whose names begin with a, b, f, g, or h.  See
  164.            "Wildcards".
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.         4DOS 4.0  [11-18-91]         UPDATE40.DOC                       page 3
  172.  
  173.  
  174.            4DOS now performs variable expansion on the prompt string, so any
  175.            environment variable, internal variable, or variable function can
  176.            be put into the prompt and displayed.
  177.  
  178.            When 4DOS exits from a shell it looks for and executes a 4EXIT.BAT
  179.            or 4EXIT.BTM file (like the 4START file).  This can be used to save
  180.            history or perform other actions.
  181.  
  182.            All upper case conversions (SETDOS /C1, DIR /C, @UPPER, etc.) now
  183.            support international characters.
  184.  
  185.            Executable extensions will now support internal commands, and they
  186.            no longer require the full path name of an executable file. Also,
  187.            executable extensions now support wildcards, including the new
  188.            extended wildcards.  For example, to set the program for all exten-
  189.            sions starting with WK to 123:
  190.  
  191.                  set .wk?=d:\123\123.com
  192.  
  193.            A "." can now be used in the PATH to delay the search of the cur-
  194.            rent directory.
  195.  
  196.            Command grouping (originally an OS/2 feature) has been added to
  197.            4DOS.  This allows you to use parentheses to group commands logi-
  198.            cally.  This is a powerful feature, especially when used with the
  199.            "prefix" commands like EXCEPT, FOR, GLOBAL, and SELECT.
  200.  
  201.            4DOS now supports Microsoft's command processor based message pro-
  202.            cessing scheme for DOS external commands.  If you enter a DOS ex-
  203.            ternal command with a bad argument (eg DEBUG XYZZY) in DOS 4 or
  204.            above you will now get a real error message (eg "File not found")
  205.            instead of a numerical message ("Extended error 2").  This feature
  206.            adds about 200 bytes to the resident size of 4DOS, and can be dis-
  207.            abled with the "MessageServer = No" directive in 4DOS.INI.
  208.  
  209.  
  210.         At the Command Line
  211.         -------------------
  212.  
  213.            The command history can now be viewed and executed from a popup
  214.            window as well as at the command line.
  215.  
  216.            "Automatic directory changes" let you change to a directory by
  217.            typing its name followed by a backslash.
  218.  
  219.  
  220.         4DOS HELP System
  221.         ----------------
  222.  
  223.            The help system has been extensively revised.  It now supports line
  224.            by line scrolling, and scrolling and paging with the mouse follow
  225.  
  226.  
  227.  
  228.  
  229.         4DOS 4.0  [11-18-91]         UPDATE40.DOC                       page 4
  230.  
  231.  
  232.            industry standard conventions.  The mouse can be used more easily
  233.            to perform most help navigation functions.
  234.  
  235.            The help text has been updated and expanded to cover all new 4DOS
  236.            features as well as MS-DOS 5 external commands.
  237.  
  238.            Help is now context sensitive.  If you press F1 from the command
  239.            line, 4DOS will try to find help for the first command on the line. 
  240.            If there is no help for that command, you will be put into the main
  241.            HELP menu.
  242.  
  243.            The help program has been renamed 4HELP.EXE to avoid conflicts with
  244.            other HELP.EXE programs.  This program is run when F1 is pressed at
  245.            the command line or when the HELP command is executed.  The help
  246.            text file is now 4DOS.HLP (for those with a utility disk, the ASCII
  247.            text file is 4DOS.TXT).  The 4HELP, 4HELPF, and 4HELPC environment
  248.            variables have been removed and replaced by the 4DOS.INI directives
  249.            HelpPath and HelpOptions.
  250.  
  251.            The new HELP system is not compatible with the version 3.0 HELP
  252.            system; if you have modified the version 3.0 HELP text you must
  253.            purchase a version 4.0 Utility Disk and recompile your help text to
  254.            use it with 4DOS 4.0 HELP.
  255.  
  256.            HELPCFG now supports a /M switch to force it to run in monochrome
  257.            mode and adjust the monochrome HELP colors, even on color systems. 
  258.            Also the HELPCFG exit keys have been changed to conform to general
  259.            usage standards.
  260.  
  261.  
  262.         I/O Redirection
  263.         ---------------
  264.  
  265.            Added a new environment variable for directing where to create the
  266.            temporary pipe files in 4DOS.  4DOS will first look for the envi-
  267.            ronment variable TEMP4DOS; if it doesn't find it it will look for
  268.            the (DOS 5 standard) TEMP variable; if it doesn't find that pipes
  269.            will be created in the root directory of the boot disk.
  270.  
  271.            Pipe names are now unique for each shell, to avoid conflicts when
  272.            running pipes in different partitions under a multitasker.
  273.  
  274.  
  275.         Environment Variables, Internal Variables, and Variable Functions
  276.         -----------------------------------------------------------------
  277.  
  278.         There are many new environment variables, internal variables, and
  279.         variable functions -- far too many to list here!  This section just
  280.         mentions a few highlights; see the manual for full details.
  281.  
  282.            New environment variables used by 4DOS include CDPATH, COLORDIR,
  283.            and TEMP4DOS.  The old TMP has been changed to TEMP for DOS 5 com-
  284.  
  285.  
  286.  
  287.         4DOS 4.0  [11-18-91]         UPDATE40.DOC                       page 5
  288.  
  289.  
  290.            patibility.  The old 4DSHELL variable has been eliminated, its
  291.            functions are now provided by 4DOS.INI.  One new variable (_CDPATH,
  292.            as opposed to CDPATH) is described in MANMOD.DOC, but is not in the
  293.            printed manual.
  294.  
  295.            New internal variables let you access a broad range of information
  296.            on system status and configuration.  Some didn't make it into the
  297.            manual:  see the beginning of this file for information on _BOOT,
  298.            _LASTDISK, _MOUSE, and _TRANSIENT.
  299.  
  300.            In addition a very large number of variable functions have been
  301.            added providing a wide array of new functions -- everything from
  302.            available memory and disk space to menuing. A few of these func-
  303.            tions didn't make it into the printed manual, so see the ASCII
  304.            manual or MANMOD.DOC for information on @ALIAS, @DEVICE, @LINES,
  305.            @MAKEDATE, @MAKETIME, @READSCR, and @SELECT, and some changes to
  306.            @LINE, @SUBSTR, and @WORD.
  307.  
  308.            Environment variable expansion will now handle nested variables in
  309.            the form %[%var] (or even %[%[%var]]!).
  310.  
  311.            There are some enhancements to specific variables and functions:
  312.  
  313.               _DATE and _TIME:  Return a leading zero if the first number in
  314.               the date or time string is less than 10.
  315.  
  316.               @EVAL:  Now supports decimal places!  Numbers can have up to 16
  317.               digits to the left of the decimal point and 8 to the right. 
  318.               Also %@EVAL now accepts commas in numbers.
  319.  
  320.               @LINE:  Now returns "**EOF**" at the end of the file. Also
  321.               @LINE can now get its input from STDIN if you specify "con" as
  322.               the filename**.
  323.  
  324.               @SUBSTR:  The last argument (the length of the string) is now
  325.               optional; it will default to the remainder of the string**.
  326.  
  327.               @WORD:  Now allows you to return words from the end of the
  328.               string**.  For example %@word[-0,now is the time] returns
  329.               "time", %@word[-2,now is the time] returns "is".
  330.  
  331.  
  332.         Aliases
  333.         -------
  334.  
  335.            The command line can now grow to up to 512 bytes while an alias is
  336.            being executed.  The alias definition itself is still limited to
  337.            255 bytes.
  338.  
  339.            "Key aliases" allow you to assign aliases to function keys and most
  340.            Alt and Ctrl keys.  See "Keystroke aliases".
  341.  
  342.  
  343.  
  344.  
  345.         4DOS 4.0  [11-18-91]         UPDATE40.DOC                       page 6
  346.  
  347.  
  348.            QUIT can now be used in aliases.
  349.  
  350.  
  351.         Batch Files
  352.         -----------
  353.  
  354.            GOSUB now saves the IFF state, so you can use IFF within subrou-
  355.            tines without interfering with an IFF in the calling section of the
  356.            batch file.
  357.  
  358.            .BAT files have been sped up significantly, especially when execut-
  359.            ing internal commands (this speed increase applies only to .BAT
  360.            files, not to .BTM files which are already much faster).
  361.  
  362.  
  363.         Command Changes
  364.         ---------------
  365.  
  366.         This section describes changes to 4DOS commands and new commands, but
  367.         only briefly.  It is intended to alert you to areas where your use of
  368.         4DOS commands may need to be changed, not to provide a comprehensive
  369.         description.  See the manual for full details.
  370.  
  371.            ATTRIB:  Added two new switches:  /Q (quiet) and /S (process cur-
  372.            rent directory and its subdirectories).
  373.  
  374.            CANCEL:  Now accepts an optional argument to set the ERRORLEVEL.
  375.  
  376.            CD and CDD:  These commands now use the CDPATH environment variable
  377.            to find the subdirectory to change to.  This allows changing to a
  378.            subdirectory without typing its full path name. Also, CD and CDD
  379.            now save the previous directory, and allow you to switch back to it
  380.            with "CD -" or "CDD -".
  381.  
  382.            CLS and COLOR:  Can now set the screen border color, and will set
  383.            colors with or without ANSI loaded.  If ANSI is not loaded, the
  384.            colors will not be "sticky" -- you may lose them when you run an
  385.            application.
  386.  
  387.            COPY:  New switches include /C (copy changed files only), /H (copy
  388.            hidden files), /N (do nothing, just test results of copy), and /S
  389.            (copy files from the current directory and its subdirectories).  /Q
  390.            (quiet) now turns off the display of the number of files copied. 
  391.            If you copy a file and the target file has a description but the
  392.            source doesn't, 4DOS will now preserve the target description; this
  393.            allows you to update files without losing the descriptions.  A full
  394.            destination disk during a COPY will now give an informative mes-
  395.            sage, and stop the copy.  COPY now preserves Hidden and System
  396.            attributes (but not Read Only) when creating the target file.
  397.  
  398.            DEL:  New switches include /N (do nothing, just test results of
  399.            DEL), /S (delete files from the current directory and its subdirec-
  400.  
  401.  
  402.  
  403.         4DOS 4.0  [11-18-91]         UPDATE40.DOC                       page 7
  404.  
  405.  
  406.            tories), /X (remove empty subdirectories), and /Z (allow deletion
  407.            of hidden, system, and read-only files).  If you have a large num-
  408.            ber of files to delete you can increase deletion speed dramatically
  409.            if you use the /Q switch and do NOT use 4DOS's extended wildcards
  410.            in the file name.
  411.  
  412.            DIR:  (See additional section below on switch changes).  Directory
  413.            displays can now be colorized with COLORDIR.  Free space displays
  414.            will be correct even on JOINed, SUBSTed, or ASSIGNed drives in DOS
  415.            3.1 and above.  File description handling has been sped up signifi-
  416.            cantly.  Directory names are displayed in square brackets [] for
  417.            DOS 5 compatibility.  If an argument begins with "\\", 4DOS will
  418.            assume it's a network reference and will not try to get the volume
  419.            label or disk space for that drive, to avoid network errors.
  420.  
  421.            DIR Switches:  Many switches have been changed for DOS 5 compati-
  422.            bility; a summary is below.  DIR now supports the DOS 5 sort order
  423.            switches (/O:[-degns]), as well as the original 4DOS switches
  424.            (/O:[-eirtuz]).  The new /O:a option sorts the directory in stan-
  425.            dard ASCII order rather than sorting filenames containing numbers
  426.            in the default numerical order.  A byproduct of the switch changes
  427.            is that the /A:xxxx and /O:xxxx switches CANNOT be followed by
  428.            another parameter without an intervening slash.  For example, you
  429.            used to be able to say DIR /OEP to display the directory in exten-
  430.            sion order with pauses.  You must now use DIR /OE/P.
  431.  
  432.                  Old Switch     Function                   New Switch
  433.                  ----------     ----------------------     ----------
  434.                     /1          Single column              no change
  435.                     /2          Two columns                no change
  436.                     /4          Four columns               no change
  437.                     /A          Display attributes            /T
  438.                     /C          Upper case                 no change
  439.                     /D          Scan subdirectories           /S
  440.                     /F          Display files only            /A:-d
  441.                     /H          Display all files             /A
  442.                     /J          Justify file names         no change
  443.                     /N          Reset DIR options          no change
  444.                     /O          Sort order                 see above
  445.                     /P          Pause at end of screen     no change
  446.                     /Q          Display file names only       /B
  447.                     /S          Display summary only          /U
  448.                     /V          Sort vertically            no change
  449.                     /W          Wide display               no change
  450.                     /X          Display directories only      /A:d
  451.                     New         Disable colorization          /D**
  452.                     New         Display full path names       /F
  453.                     New         Suppress header               /K
  454.                     New         Lower case                    /L
  455.                     New         Suppress footer               /M
  456.  
  457.  
  458.  
  459.  
  460.  
  461.         4DOS 4.0  [11-18-91]         UPDATE40.DOC                       page 8
  462.  
  463.  
  464.            DRAWBOX:  Added a new "shadow" option to create a transparent drop
  465.            shadow for the box.
  466.  
  467.            ECHOS:  This is a new command which works just like an ECHO, but
  468.            doesn't print a CR/LF at the end of a line.  It's useful when redi-
  469.            recting output to a printer or other device.
  470.  
  471.            ESET:  The new /M switch makes the change to the master environ-
  472.            ment, not the local one.
  473.  
  474.            EXIT can now accept and return a result code (error level) to the
  475.            program that started a secondary shell.
  476.  
  477.            FOR:  The set to be processed can now be read from a file.  The new
  478.            /A: switch allows selection of files for processing based on at-
  479.            tributes, using the same syntax as DIR /A**.
  480.  
  481.            GLOBAL:  Added switches /H (process hidden directories) and /P
  482.            (prompt before executing the command in each directory)**.
  483.  
  484.            GOTO:  Added a /I switch which tells 4DOS to NOT cancel IFF pro-
  485.            cessing.  (Use only if you know EXACTLY what you're doing, and
  486.            don't attempt to jump outside of the IFF or into a different IFF or
  487.            IFF nesting level!)
  488.  
  489.            HISTORY:  Two switches were added:  /A adds a command to the histo-
  490.            ry list; /P pauses after displaying each page of the history.
  491.  
  492.            IF and IFF:  Most of the old tests for system resources (EMS, XMS,
  493.            DISKFREE, etc.) have been moved to variable functions to make the
  494.            information available throughout 4DOS rather than just in IF and
  495.            IFF.  You will need to edit your batch files or aliases if you used
  496.            these tests in IF or IFF commands (see below).  New conditional
  497.            operators .AND., .OR., and .XOR. have been added.  Some new tests
  498.            have been added:  ISINTERNAL tests if a string matches the name of
  499.            an internal command; ISLABEL tests if a label exists in the current
  500.            batch file**.
  501.  
  502.                  Old IF / IFF test       New Variable or Variable Function
  503.                  -----------------       ---------------------------------
  504.                     MONITOR              %_MONITOR
  505.                     VIDEO                %_VIDEO
  506.                     ATTRIB               %@ATTRIB[filename,attrib]
  507.                     DISKFREE             %@DISKFREE[d:,b|k|m]
  508.                     DOSMEM               %@DOSMEM[b|k|m]
  509.                     EMS                  %@EMS[b|k|m]
  510.                     EXTENDED             %@EXTENDED[b|k|m]
  511.                     FILESIZE             %@FILESIZE[filename,b|k|m]
  512.                     XMS                  %@XMS[b|k|m]
  513.  
  514.            INKEY:  The new /K switch specifies the permissible keystrokes**.
  515.  
  516.  
  517.  
  518.  
  519.         4DOS 4.0  [11-18-91]         UPDATE40.DOC                       page 9
  520.  
  521.  
  522.            KEYSTACK:  Key names can be entered mnemonically, and delays can
  523.            now be included in the keystroke sequence.  The KEYSTACK.SYS device
  524.            driver has been removed and replaced by a TSR, KSTACK.COM.
  525.  
  526.            LH:  New command added to support DOS 5's load high capability.
  527.  
  528.            LIST:  Now saves your position on a search or a print, and returns
  529.            you to it after the print or an unsuccessful search.  You can now
  530.            toggle the high bit (/H) and line wrap (/W) flags from inside LIST,
  531.            and /W(rap) now affects the P(rint) option.
  532.  
  533.            LOADHIGH:  New command added to support DOS 5's load high capabili-
  534.            ty.
  535.  
  536.            LOG:  The LOG state and file name are now inherited by secondary
  537.            shells.  The log file name and/or path can be set with the LogName
  538.            directive in 4DOS.INI** (using LogName does not turn logging on,
  539.            you must still use LOG ON to do so).
  540.  
  541.            MOVE:  New switches include /C (move changed files only), /D (re-
  542.            quire that the destination be a directory), /H (move hidden files),
  543.            /N (do nothing, just test results of move), and /S (move files from
  544.            the current directory and its subdirectories).  /Q (quiet) now
  545.            turns off the display of the number of files copied.  If you move a
  546.            file and the target file has a description but the source doesn't,
  547.            4DOS will now preserve the target description; this allows you to
  548.            update files without losing the descriptions.  A full destination
  549.            disk during a MOVE will now give an informative message, and stop
  550.            the move.
  551.  
  552.            PROMPT:  Environment variables, internal variables, and variable
  553.            functions can now be used from within the prompt, allowing you to
  554.            include a wide variety of values in your prompt text.  The case of
  555.            the path displayed in the prompt is now controlled solely by the $P
  556.            and $p characters, and is not affected by SETDOS /U.
  557.  
  558.            QUIT:  Now accepts an optional argument to set the ERRORLEVEL.
  559.  
  560.            REBOOT:  This is a new command which does a warm or cold boot, with
  561.            an optional verification prompt.  You need to test it on your sys-
  562.            tem as some reboot methods do not work on all systems or with all
  563.            other software.
  564.  
  565.            REN has two new switches:  /N (do nothing, just test results of
  566.            rename); /S (allow subdirectory renames).  Subdirectory renames are
  567.            now disabled if wildcards are used in the old name, to avoid inad-
  568.            vertent renaming of directories; you can enable them with /S.
  569.  
  570.            SELECT:  There are some new switches and switch changes:  /A se-
  571.            lects files based on attribute (see DIR), /C displays in upper
  572.            case, /D disables directory colorization**, and /O has the same
  573.            changes as in DIR.  A "*" now reverses the marks on all files,
  574.  
  575.  
  576.  
  577.         4DOS 4.0  [11-18-91]         UPDATE40.DOC                      page 10
  578.  
  579.  
  580.            rather than simply marking all files -- for example, if you mark 3
  581.            files and then press '*' SELECT will unmark those three files and
  582.            mark all the others.  You can now unmark all of the marked files
  583.            with a '/'.
  584.  
  585.            SET:  The new /M switch makes the change to the master environment,
  586.            not the local one.  The syntax has been changed to match
  587.            COMMAND.COM:  you MUST enter an '=' in a SET statement, and you may
  588.            now put whitespace in the variable name or the argument.  Also, if
  589.            you enter SET VARNAME with nothing else on the line SET will now
  590.            display the value of the variable, rather than removing it from the
  591.            environment as it used to.  To remove an environment variable, you
  592.            must add the "=" sign to the end (e.g. SET VARNAME=), or use UNSET. 
  593.            Also note that, because whitespace in environment variable names
  594.            and values is now preserved, batch files with lines like
  595.            "SET MYVAR = MYVALUE" may not work unless they are changed to elim-
  596.            inate the extra spaces.  Under 4DOS 3.03 this example would set
  597.            "MYVAR" to "MYVALUE; under 4DOS 4.0 it will set "MYVAR " to
  598.            " MYVALUE".
  599.  
  600.            SETDOS:  The /A option can now be set to tell 4DOS that ANSI is not
  601.            loaded (/A2).  The /H option has been removed; the minimum length
  602.            of a command to save can be set with the HistMin option in
  603.            4DOS.INI.  The /S option now uses percentages, not line counts, to
  604.            set the cursor shape for insert and overstrike modes.  The /U op-
  605.            tion no longer affects the case of the path displayed in the 4DOS
  606.            prompt; that is now controlled solely by the $P and $p PROMPT char-
  607.            acters.  The /V option can now be set to echo everything, even if
  608.            echo is off (/V2)**.
  609.  
  610.            SWAPPING:  Now displays the current swapping type (EMS, XMS, Disk,
  611.            or None) as well as the swapping state.
  612.  
  613.            TIMER:  There are now three timers available, selected with /1, /2,
  614.            or /3.  TIMER ON can be used to force a reset of the timer regard-
  615.            less of the current state.
  616.  
  617.            TRUENAME:  This is a new command which displays the true name of a
  618.            file, even on ASSIGNed, JOINed, or SUBSTed drives.
  619.  
  620.            UNSET:  The new /M switch makes the change to the master environ-
  621.            ment, not the local one.
  622.  
  623.            VER:  The new /R switch displays the DOS revision level and loca-
  624.            tion of the DOS kernel (DOS 5 only)**.
  625.  
  626.            VSCRPUT:  This is a new command which has the same parameters as
  627.            SCRPUT, but displays the string vertically.
  628.  
  629.  
  630.  
  631.  
  632.  
  633.  
  634.  
  635.         4DOS 4.0  [11-18-91]         UPDATE40.DOC                      page 11
  636.  
  637.  
  638.         Technical Changes
  639.         -----------------
  640.  
  641.         These changes are primarily of interest to programmers and others
  642.         interested in "how 4DOS works".  Most users do not need to read this
  643.         information.
  644.  
  645.            New programming interfaces are included in version 4.0; see Appen-
  646.            dix C of the manual for details.  These include a new KEYSTACK
  647.            interface, installable commands, and extended information in the
  648.            DESCRIPT.ION file.
  649.  
  650.            Full support for INT 2E is now provided.  See the "Appendix C"
  651.            section of this file for details.
  652.  
  653.            4DOS now reserves all available DOS RAM while it is running at the
  654.            prompt.  This space is freed as needed for BTM files, DIR, LIST,
  655.            SELECT, etc., and is always freed when starting an application. 
  656.            This mimics COMMAND.COM; we have implemented it to get around some
  657.            odd behavior with loading certain networks or TSRs which depend on
  658.            this approach.
  659.  
  660.            4DOS now detects a version mismatch with a previous shell and dis-
  661.            ables alias and history inheritance and reduced swapping if one is
  662.            found.
  663.  
  664.            4DOS now supports third-party INT 24 (critical error) handlers like
  665.            4DOS24H, and will no longer disable them when an unruly TSR
  666.            unloads.
  667.  
  668.            The 4DOS transient portion is now 100% dynamically relocatable. 
  669.            This means if you have a TSR that grabs a block from the end of DOS
  670.            memory, 4DOS will dynamically relocate itself below the TSR when it
  671.            swaps in after the TSR goes resident.  The only thing you can't do
  672.            is load such a TSR with swapping off, then turn swapping back on. 
  673.            If you do the results will not be good.
  674.  
  675.            Reduced swapping is now enabled all the time.  Starting a secondary
  676.            shell under DESQView, or when alias or environment space is expand-
  677.            ed, etc., will no longer result in a full-sized swap area.  The
  678.            only way to get a full-sized swap area in a secondary shell is to
  679.            force it with the Reduce = NO directive in 4DOS.INI, or to load one
  680.            version of 4DOS on top of another.
  681.  
  682.            The maximum internal line size in 4DOS has been increased from 255
  683.            to 512 characters.  The maximum command line length is still 255,
  684.            but the increase in the internal buffer will allow you to have more
  685.            complex aliases, variables, and command groups.
  686.  
  687.            4DOS will now "short-circuit" attempts by certain programs to do a
  688.            "4DOS /C 4DOS" (ie load 4DOS and tell it to load itself again) when
  689.            shelling to DOS.  When this occurs 4DOS will only be loaded once.
  690.  
  691.  
  692.  
  693.         4DOS 4.0  [11-18-91]         UPDATE40.DOC                      page 12
  694.  
  695.  
  696.  
  697.         COMPATIBILITY CHANGES
  698.         ---------------------
  699.  
  700.         This section gives a quick overview of changes to 4DOS 4.0 to enhance
  701.         compatibility with other software.  For details on any specific pack-
  702.         age see APPNOTES.DOC.
  703.  
  704.            ANSI:  4DOS has improved ANSI detection and now will usually cor-
  705.            rectly detect whether ANSI is loaded regardless of whether ANSI or
  706.            DOS is loaded high or low.  If you have problems with ANSI detec-
  707.            tion use SETDOS /A or the ANSI directive in 4DOS.INI to tell 4DOS
  708.            whether ANSI is installed.
  709.  
  710.            APPEND:  4DOS sets APPEND's /PATH:OFF flag if using DOS 4 or DOS 5. 
  711.            This will eliminate any attempt by APPEND to extend its searches in
  712.            a way that interferes with 4DOS file access and file descriptions.
  713.  
  714.            DESQview:  A Close Window command from within 4DOS will now release
  715.            all resources (XMS, EMS, UMB, swap file, shell number, interrupts)
  716.            owned by 4DOS before the window is closed, just as if you typed
  717.            EXIT.  4DOS only performs this cleanup if you are actually in 4DOS
  718.            when you issue the Close Window command.  If you are in an applica-
  719.            tion the cleanup will not occur.
  720.  
  721.            DR-DOS:  Several changes have been made for DR-DOS compatibility
  722.            including access to 4DOS extended wildcards, and use of DR-DOS
  723.            passwords (the ";" must be doubled on certain commands for this to
  724.            work).
  725.  
  726.            Novell Netware:  Numerous changes have been made to improve Netware
  727.            compatibility, especially with 4DOS redirection and batch files. 
  728.            Novell has also fixed bugs which would cause environment variables
  729.            to be destroyed when logging in to the network under 4DOS.  Also,
  730.            you can now swap secondary shells to a network drive using the
  731.            SwapReopen dircetive in 4DOS.INI.
  732.  
  733.            Windows:  4DOS now detects Windows 3 and configures itself accord-
  734.            ingly.  At startup you will get a message:  "4DOS running under
  735.            Windows 3 in [Win3 mode]".  There will be no message if you aren't
  736.            running under Win3.  Memory allocation in Win3 is now automatic,
  737.            hence there is no need for the old /V switch.
  738.  
  739.  
  740.  
  741.  
  742.  
  743.  
  744.  
  745.  
  746.  
  747.  
  748.  
  749.  
  750.  
  751.         4DOS 4.0  [11-18-91]         UPDATE40.DOC                      page 13
  752.  
  753.